home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 088 / catchcat.arc / CATCHCAT.DOC < prev   
Encoding:
Text File  |  1987-09-29  |  18.1 KB  |  526 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                     CATCHCAT
  34.                                 Version 1.00/1.50
  35.                                From WIZARD'S WARE
  36.                                   by Jon Glazer
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.        PREFACE:
  45.  
  46.             CATCHCAT version 1.00 is a SHAREWARE version.  This means that
  47.        it is  a limited  version and  may be  distributed in any means you
  48.        feel fit.  It's limitations are based on the actual program itself,
  49.        that is, some options have been removed.
  50.  
  51.             CATCHCAT version  1.50 is  a REGESTERED USERS ONLY version and
  52.        is complete in both documentation  and  options.    To  obtain your
  53.        registered version, simply send a check for $10 to
  54.  
  55.                                    Jon Glazer
  56.                                1906 N. Hulmac rd.
  57.                               Columbus, Ohio  43229
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.        INTRODUCTION:
  66.  
  67.             CatchCat  is  the  result  of  long  hours  of sifting through
  68.        kilobytes of files searching for bogus names, good users, unpopular
  69.        files and old messages.  I decided there has got to be a better way
  70.        of doing this other than going through printouts of information and
  71.        trying to  "eyeball" the  the information I wanted.  Well, CatchCat
  72.        is the alternative.  It will  not  only  give  you  the information
  73.        described above  but will  give you  information about any field of
  74.        WILDCAT!'s main files.
  75.             CatchCat uses a very basic DBase type structure to do searches
  76.        through  the  FILEINFO.DAT,  MSGHEADR.DAT,  and  USERINFO.DAT files
  77.        based on keys you  specify.   With CatchCat  you should  be able to
  78.        determine the  effectiveness of  your BBS  and to make it much more
  79.        efficient by removing unpopular files, old  messages, users  who do
  80.        not  call  for  a  long  period  of  time  etc...  by  listing this
  81.        information on the screen, on your printer and even remotely.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.        HOW IT WORKS:
  90.  
  91.             CatchCat does  not  alter/modify  or  do  anything  related to
  92.        actually changing  the data  in the  files it  uses.  It is only an
  93.        information retrieval tool.
  94.             Each data  file  used  by  WILDCAT!  incorporated  records and
  95.        specific record  structures making  up a variety of specific fields
  96.        such as user name, password, etc....  CatchCat makes use of most of
  97.        the  separate  fields  in  these  file  to  give  you  most  of the
  98.        information you could possibly desire.
  99.             To obtain your information,  you simply  specify the  type you
  100.        would  like   and  the   comparison.    Comparisons  consist  of  a
  101.        rudimentary "IF-THEN"  statement  with  relational  operators being
  102.        ">,<,=,!".  These break down as follows:
  103.  
  104.                     > - is Greater than
  105.                     < - is Less than
  106.                     = - is Equal to
  107.                     ! - is "Not" Equal to
  108.  
  109.             There are  three basic  catagories of tests.  Tests on NUMERIC
  110.        data, TEXT  data, and  BOOLEAN data,  each having  it's own syntax.
  111.        There is  a third  category, DATEs,  which is a combination of TEXT
  112.        and NUMERIC tests (explained later).
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.        RUNNING REMOTELY:
  121.  
  122.             CatchCat can run over a communications port using standard DOS
  123.        redirection.   The opening  screen, however, will be displayed only
  124.        on the it's local screen.  When running  CatchCat remotely  keep in
  125.        mind  that  there  is  a  delay between running the program and the
  126.        actual operation.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.        INFORMATION DATABASES:
  133.  
  134.             CatchCat uses  the  three  main  databases  that  are  used in
  135.        WILDCAT!.  These being:
  136.  
  137.                     FILEINFO.DAT    Files data
  138.                     MSGHEADR.DAT    Message Header data
  139.                     USERINFO.DAT    Users data
  140.  
  141.             CatchCat is divided into three sections to access three bases.
  142.        When  first  running  the  program  the following menu will come up
  143.        after the opening screen:
  144.  
  145.                         WILDCAT! Information Center
  146.                         
  147.                              Information on:
  148.                                 U)sers
  149.                                 F)iles
  150.                                 M)essages
  151.  
  152.                                 Q)uit
  153.                          Select One>
  154.  
  155.        Here you would select the appropriate base.
  156.  
  157.             Each  of  the  three  selections  above  will  produce  a menu
  158.        specific to  the information available in that base.  Before we get
  159.        into each menu separately, let's talk  about syntax  for the search
  160.        keys.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.        SEARCH TYPES
  169.  
  170.        NUMERIC SEARCHES:
  171.  
  172.             Searching a  base for numeric information is probably the most
  173.        straight-forward of all.    It's  syntax  is  basic  algebra.   For
  174.        example, if we were to search for USER DOWNLOADS represented by the
  175.        letter "D", the following sample searches could be specified:
  176.  
  177.        |    You type  |      Description                              |
  178.        |    D>10      | Users who have downloaded more than 10 files. |
  179.        |    D<10      |   ""   "  ""     ""       less  ""  ""  ""    |
  180.        |    D=10      |   ""   "  ""     ""       exactly 10 files.   |
  181.        |    D!10      |   ""   "  ""   NOT downloaded exactly 10 files|
  182.  
  183.        TEXT SEARCHES:
  184.  
  185.             A text search is slightly more involved than  numeric searches
  186.        but again,  easy to  understand.   A text search would allow you to
  187.        search for specified text within the  desired field.   The  ">" and
  188.        "<" operators  default to "=" in this type of search. The "!" would
  189.        specify  fields  WITHOUT  the  given  text,  for  example,  let "N"
  190.        represent user names:
  191.  
  192.        |    You Type   |     Description                              |
  193.        |     N=MARK    | Users with "MARK" in there name are displayed|
  194.        |     N=oh      | Users with "OH" in their name such as JOHN...|
  195.        |               |    or JOHNSON etc...                         |
  196.        |     N>oh      | Same as "N=oh"                               |
  197.        |     N!SAM     | Users who do not have "SAM" in their name    |
  198.  
  199.        BOOLEAN SEARCHES:
  200.  
  201.             Boolean searches  involve only two types of qualifiers, either
  202.        it is "TRUE" or "FALSE".  CatchCat recognizes "-" and  "+" as false
  203.        and true  respectively and  will not except any other character for
  204.        these searches.  For example, let  "G" represent  the color graphic
  205.        menu  selection  of  the  users  (either  on/off  or  in  this case
  206.        true/false):
  207.  
  208.        |    You Type    |     Description                             |
  209.        |      G+        |  Users who have graphics selected will be   |
  210.        |                |     displayed                               |
  211.        |      G-        |  Users who do NOT have graphics are shown.  |
  212.  
  213.        DATE SEARCHES:
  214.  
  215.             Perhaps the most difficult of the  searches to  visualize, the
  216.        date search is probably the most powerful.  It allows you to do all
  217.        the same types of searches available in the numeric search on eight
  218.        character  dates.    It  is  VERY important that the dates be eight
  219.        characters, that is, the month number, the day number and  the year
  220.        number all  two digit  integer separated  by any character you wish
  221.        (ie. 09/01/87 or 09-01-87 or 09 01 87).  Date searches are based on
  222.  
  223.  
  224.  
  225.  
  226.  
  227.        early dates  being less than later dates.  In other words a date of
  228.        "04/25/64" is less than "05/02/72".   With this  operation, you can
  229.        search for new users since ... or files older than ... etc....  For
  230.        example, let "B" represent a users birthdate:
  231.  
  232.        |    You Type    |     Description                           |
  233.        |    B<09/04/63  |  Users born before 09/04/63 are selected  |
  234.        |    B>09/04/63  |  Users born after 09/04/63 are displayed  |
  235.        |    B=09/04/63  |  Users born ON 09/04/63 are displayed     |
  236.        |    B!09/04/63  |  Users NOT born on 09/04/63 are displayed |
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.        THE OUTPUT:
  245.  
  246.             The lists derived  form  each  search  contains  a  variety of
  247.        information.   In the  first column  will always  appear the record
  248.        number of the database.  The next column (or two)  will contain the
  249.        information that  would allow  you to  identify the  USER, FILE, or
  250.        MESSAGE, and the last column will contain the actual or  TRUE VALUE
  251.        of  the  data  found  in  that  record.    In  other words, if your
  252.        searching for numbers greater than 10, anything from 11 on  up will
  253.        be displayed.   The  columns DO  NOT CHANGE SIZE to match the data.
  254.        This will sometimes result in wasted space but it is  better than a
  255.        lot of blank screen.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.        THE SUB MENUS:
  264.  
  265.             Each  sub   menu,  again,  has  specific  areas  of  interest.
  266.        However, they all have  two things  in common.   Entering  "Q" will
  267.        quit to  the main  menu and entering "H" will toggle the printer on
  268.        and off.   The  printer will  only print  pertinent information for
  269.        specified  searches  only.    This  means  menus are not printed as
  270.        aren't the page breaks.
  271.  
  272.  
  273.  
  274.  
  275.  
  276.             All sub menu elements are labeled with their specific types of
  277.        searches and input expected:
  278.                            
  279.                       [T]=Text search
  280.                       [D]=Date search
  281.                       [N]=Numeric search
  282.                       [B]=Boolean search
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.        THE USERS MENU:
  292.  
  293.        S)ecurity level   *** NUMERIC ***
  294.             This  is,  surprisingly  enough,  the  specifier  for security
  295.        levels.   Using the  same syntax  as above,  you should  be able to
  296.        obtain some very important information.     
  297.  
  298.        L)ines per page   *** NUMERIC ***
  299.             This  would  allow  you  to  see if users specified a bad page
  300.        length.
  301.  
  302.        D)ownloads -TOTAL-   *** NUMERIC ***
  303.             This would display total downloads for the users.
  304.  
  305.        U)ploads -TOTAL-    *** NUMERIC ***
  306.             This would display total uploads for the users.
  307.  
  308.        K)Bytes downloaded    *** NUMERIC ***
  309.             This would display the total  number  of  BYTES  the  user has
  310.        downloaded.
  311.  
  312.        Y)-KBytes uploaded    *** NUMERIC ***
  313.             Slightly  cryptic  for  lack  of  another  symbol,  this would
  314.        display the total number of bytes the user has uploaded.
  315.  
  316.        T)imes on    *** NUMERIC ***
  317.             This would display the number of  times the  user has  been on
  318.        the system.
  319.  
  320.        M)essages read    *** NUMERIC ***
  321.             This  would  display  the  message  number of the last message
  322.        read.  "M<1" would show users who have never read any messages.
  323.  
  324.        N)ame search    *** TEXT ***
  325.             This would scan the  names  of  each  user  and  display those
  326.        containing the specified text.
  327.  
  328.        P)assword search    *** TEXT ***
  329.             This would  scan the  passwords of each user and display those
  330.        containing the specified text.
  331.  
  332.        #)-phone num. search    *** TEXT ***
  333.             this would  scan the  phone numbers  of each  user and display
  334.        those containing  the specified  text. "#=404-" would display users
  335.        with the area code 404 or a the suffix 404.
  336.  
  337.        R)esidence    *** TEXT ***
  338.             This would scan the  location of  each user  and display those
  339.        containing the specified text.
  340.  
  341.        B)irth date    *** DATE ***
  342.             This  would  display  the  users  with birthdates in the range
  343.        specified.
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.        F)ile search   *** DATE ***
  351.             This would display the  users  who  have  done  a  "New files"
  352.        search with in the date-range specified.
  353.  
  354.        O)n since    *** DATE ***
  355.             This would display users who first registered within the date-
  356.        range specified.
  357.  
  358.        C)omputer type    *** TEXT ***
  359.             This would  scan the  computer type  of each  user and display
  360.        those containing the specified text.
  361.  
  362.        V)isit last    *** DATE ***
  363.             This would  display the  users who  have (or have not) visited
  364.        within the specified date-range.
  365.  
  366.        J)oined folders    *** TEXT ***
  367.             This would  scan the  folders each  user has  open and display
  368.        those that contain the specified text.
  369.  
  370.        G)raphics selected    *** BOOLEAN ***
  371.             This would  display the  users who have (or have not) selected
  372.        color menus.
  373.  
  374.        *)-Locked out users    *** BOOLEAN ***
  375.             This would display the users who are (or  are not)  locked out
  376.        at the present time.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.        THE FILES MENU:
  385.  
  386.        N)ame search    *** TEXT ***
  387.             This would  scan the file names of each file and display those
  388.        that contain the specified text.
  389.  
  390.        D)ate search   *** DATE ***
  391.            This would scan the date of  each file  and display  those that
  392.        have been installed within the specified date.
  393.  
  394.        T)ext scan in desc.   *** TEXT ***
  395.            This would  scan the description of each file and display those
  396.        that  contain  the  specified  text.    Since  the  description can
  397.        effectively be  eighty characters,  and the  space alloted to it in
  398.        the "TRUE VALUE" column is  only  fifty  characters,  CatchCat will
  399.        display the  first forty nine characters and place a "*" at the end
  400.        of the line indicating that the line is longer than it appears.
  401.  
  402.        U)ploader    *** TEXT ***
  403.            This would scan the names of  the  uploader  of  each  file and
  404.        display those that contain the specified text.
  405.  
  406.        A)ccess date    *** DATE ***
  407.            This  would  scan  the  date  of  the  last  time each file was
  408.        downloaded and display those  who have  been downloaded  within the
  409.        specified date-range.   This  would let  you know  which files have
  410.        been popular lately and tell you which ones you can delete.
  411.  
  412.        #)-of downloads    *** NUMERIC ***
  413.            This would display the names of  all the  files that  have been
  414.        downloaded within the number of times specified.
  415.  
  416.        S)ize    *** NUMERIC ***
  417.             This would display the names of all the files that have a size
  418.        within the specified range.
  419.  
  420.        F)lag for passwords    *** BOOLEAN ***
  421.             This would display the names of  all the  files that  have (or
  422.        have not) a password assigned to it.
  423.  
  424.        P)assword   *** TEXT ***
  425.             This would  scan the  passwords of  all the  files and display
  426.        those that contain the specified text.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.        THE MESSAGE MENU:
  435.  
  436.        D)ate of mess.   *** DATE ***
  437.             This would scan the  dates of  all messages  and display those
  438.        that were sent within the specified date-range.
  439.  
  440.        A)uthor   *** TEXT ***
  441.            This  would  scan  the  name  of the sender of each message and
  442.        display those that contain the specified text.
  443.  
  444.        T)o   *** TEXT ***
  445.            This would scan the name of  the receiver  of each  message and
  446.        display those that contain the specified text.
  447.  
  448.        S)ubject scan   *** TEXT ***
  449.            This would  scan the  subject of each message and display those
  450.        that contain the specified text.
  451.  
  452.        C)onference   *** TEXT ***
  453.            This would display each message number  that is  located in the
  454.        specified conference folder.
  455.  
  456.        L)ines    *** NUMERIC ***
  457.            This would display the message number of all messages that have
  458.        a size within the specified range.
  459.  
  460.        P)rivate    *** BOOLEAN ***
  461.            This would display the message number  of each  message that is
  462.        (or is not) private.
  463.  
  464.        F)orwarded    *** BOOLEAN ***    
  465.            This would  display the  message number of each message that is
  466.        actually forwarded from the original.
  467.  
  468.        N)otify flag    *** BOOLEAN ***
  469.            This would display the message number of each  message than has
  470.        the receipt flag set accordingly.
  471.  
  472.        X)erox (C.C.)   *** BOOLEAN ***
  473.            This would  display the message number of all messages that are
  474.        actually carbon copies of originals.
  475.  
  476.        R)ecieved   *** BOOLEAN ***
  477.            This would display the message number of all  the messages that
  478.        have been received but not K)illed.
  479.  
  480.        1)-reply from  *** NUMERIC ***
  481.            Slightly  cryptic  for  lack  of  a  better  symbol, this would
  482.        display the message numbers of the all messages that are replies to
  483.        originals.   The "TRUE VALUE" column would show the message numbers
  484.        of the original message.  Normally a search of "1>0"  would be used
  485.        to display all messages that are replies.
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.        2)-see reply   *** NUMERIC ***
  494.            Slightly  cryptic  for  lack  of  a  better  symbol, this would
  495.        display the message numbers of all messages that have replies.  The
  496.        "TRUE VALUE" column would show the message number of the reply.
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.        ERRORS:
  504.  
  505.             CatchCat has a rather extensive error trapping routine for all
  506.        operations but dates.  It does not check for valid months (1-12) or
  507.        days (1-31)  and will  work for years between 0 and 99.  If you get
  508.        an error about a bad date it is probably referring  to a  bad input
  509.        syntax.
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.        DISCLAIMER:
  517.  
  518.             CatchCat  and  it's  author  can  in no way be held liable for
  519.        damage to data or equipment.  While this program has been tested on
  520.        various equipment  it has  not been  tested on all kinds.  Also, it
  521.        was designed for WILDCAT! version 1.03  ONLY!!   While it  may work
  522.        with other  versions, there is no guarantee as to it's performance.
  523.        However, there is no program statements that even  vaguely write to
  524.        any type of file so an attempt to use this with bad data should not
  525.        result in a corrupted file.
  526.